home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
pascal
/
totsrc11.zip
/
README
< prev
next >
Wrap
Text File
|
1993-05-04
|
26KB
|
576 lines
WELCOME TO TECHNOJOCK'S OBJECT TOOLKIT
--------------------------------------
This README file contains important information about TechnoJock's
Object Toolkit (TOT) version 1.10. For the latest information about
TOT, the accompanying programs and the manual, read this file in
its entirety. To print this file, just press T and specify a printer
port or a filename.
TABLE OF CONTENTS
-----------------
1. Usage Hints
2. Using the Demos
3. TOT Enhancements and Undocumented Features
4. The Norton Guides TOT Database
5. Files on the Disks
6. Shareware
7. Printing the Manual
8. Installation
9. Association of Shareware Professionals
+----------------------------------------------+
| P a r t 1 - U s a g e H i n t s |
+----------------------------------------------+
Many of you will want to start using the Toolkit immediately. However, we
really do recommend that you read the first three chapters of the User's
Manual before you start coding. Ideally, you should read the entire
manual - after all, we wrote it in the hope that you would!
If you insist on using the Toolkit without reading the documentation, at
least follow these hints:
1) The Toolkit includes the following, globally declared and initialized
objects:
SCREEN - for writing to the visible screen
KEY - for accessing the keyboard
MOUSE - for controlling the mouse location and shape
MONITOR^ - a POINTER to an object controlling display
characteristics
LOOKtot^ - a POINTER to an object controlling default
colors, etc.
SHADOWtot^ - a POINTER to an object controlling shadow
characteristics
SCROLLtot^ - a POINTER to an object controlling scroll bar
characteristics
DATEtot^ - a POINTER to an object controlling date
characteristics
IOtot^ - a POINTER to an object controlling the form
input defaults
ALPHABETtot^ - a POINTER to an object controlling how the
TOOLKIT manipulates upper- and lower-case chars
2) If you create any other object instances (i.e. variables), make
sure you call the INIT method before any others, and the DONE method
when you are finished. The following code fragment illustrates how you
could use the ScreenOBJ object to save and restore the visible screen:
var SaveScreen: ScreenOBJ;
begin
SaveScreen.Init;
SaveScreen.Save;
{...}
{other procs which write to the screen}
{...}
SaveScreen.Display;
SaveScreen.Done;
end;
IMPORTANT NOTE: don't call the INIT and DONE methods for the
global instances described in hint 1).
3) Enable the FINAL directive in the TOTFLAGS.INC file to minimize
program size.
4) Run the demos to see how each unit can be used (discussed next).
+---------------------------------------------------+
| P a r t 2 - U s i n g t h e D e m o s |
+---------------------------------------------------+
There are over 80 demo programs in the Toolkit. The majority of these
demos are designed to illustrate a specific finite part of the Toolkit. They
are referred to at the appropriate places in the documentation. Listed below
is a summary of the demo files:
DEMBR1-5 Browse demos
DEMBX1-3 Box demos
DEMCU1 Cursor demo
DEMDR1-7 Directory demos
DEMDT1-2 Date demos
DEMEX1-2 DOS EXEC demos
DEMFS1-2 Screen writing demo
DEMIN1-4 Keyboard and mouse input demo
DEMIO1-24 Form Input demos
DEMLK1-2 Link list demos
DEMLS1-9 List demos
DEMMN1-9A Menu emos
DEMMS1-8 Message demos
DEMOV1-2 Overlay demos
DEMSC1 Scroll bar demo
DEMSH1 Shadow demo
DEMST1-3 String demos
DEMSY1 System demo
DEMVI1 Virtual screen demo
DEMWI1-4 Window demos
DEMWR1 Screen writing demo
EXTDEM1-8 Extension demos
TOTDEMO Overall Demo
If your goal is to appreciate the power of the Toolkit, then consider
running the following demos (as well as being educational, they have visual
impact):
TOTDEMO
DEMIO21,22
DEMLS9
DEMMN9
DEMBR5
A special thank-you to George Butts and George Bean, two Toolkit users who
have generously given us some programs they developed with the Toolkit. Try
running the programs
TBROWSE
TELE
to see how easy the Toolkit is to use!
+-----------------------------------------------+
| P a r t 3 - E n h a n c e m e n t s |
+-----------------------------------------------+
This section identifies any last minute changes that have been made since
the documentation was printed. The following topics are discussed:
1) International Customization
2) Additions to totMISC
3) Key Constants
4) Further IO Extensions
5) Additional Methods
6) Overlaying the Toolkit
1) INTERNATIONAL CONSIDERATIONS
===============================
The TOTIO2.PAS unit includes the following declarations:
CONST
NumberError: array[1..2] of string[60] =
(' The number you entered is out of range. ',
' Enter a number in the following range: ');
DateError: array[1..6] of string[60] =
(' The date you entered is invalid. ',
' Enter a date in the format:',
' The date you entered is too early. ',
' The earliest acceptable date is: ',
' The date you entered is too late. ',
' The latest acceptable date is: ');
NumberError is an array of strings with two elements. These two elements
represent the text that is displayed if an out-of-range value is
entered in an IO field.
DateError is an array of strings with six elements. This array includes
three pairs of strings which represent the various messages which are
displayed when an invalid or out-of-range date is entered in a date field.
Similarly, the totLINK unit includes the following declaration:
Const
NoFiles: string[20] = 'No Files';
The text is displayed in directory listings when no file is found.
You may customize these messages as necessary.
Refer to the Toolkit documentation on AlphabetTOT and DateTOT for other
customization considerations.
2) ADDITIONS to TOTMISC
=======================
The following procedures and functions have been added to the totMISC
unit, and are not discussed in the manual:
function DeleteFile(Filename:string): shortint;
Deletes a file from the disk, and returns a shortint code as
follows: -1 File not found
0 File deleted
1 Error - file not deleted.
function RenameFile(Oldname,NewName:string):shortint;